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XMLTVFormat 


XMLTV File format 


The format used differs from most other XML-based TV listings formats in that it is written from the user's point of view, rather that 


helpful links | the broadcaster's. It doesn't divide listings into channels, instead all the channels are mixed together into a single unified listing. 

| m Main Page Each programme has details such as name, description, and credits stored as supplements, but metadata like broadcast details 
m Sourceforge Project are stored as attributes. There is support for listings in multiple languages and each programme can have ‘language’ and ‘original 
= Download Info language’ details. 

| m Nghtly Status s bi A 5 ae A 
ia The XMLTV File Format was originally created by Ed Avis, and is currently maintained by the XVILTVProject. The current CVS 
i version of the DTD is available here 


There are additional requirements on grabbers if they want to be "baseline compliant". See XmltvCapabil 
Since the DTD is available, you can also use XmltWalidation. 


Details 


An XMLTV file has 2 types of records 

= ‘channel records, store information about channels 

= ‘program’ records, store information about individual episodes 

Most of the information is optional and may not be available from all sources 
This is what a sample xmltv file looks like 


<?xml version="1,0" encoding="IS0-8859-1"2> 
<!DOCTYPE tv SYSTEM "xmltv.dtd"> 


<tv source-info-url="http: //www.schedulesdirect.org/" source-info-name: 

<channel id="110436, labs. zap2it .com"> 

<display-name>13 KERA</display-name> 
<display-name>13 KERA TX42822:~-</display-name> 

splay-name>13</display-name> 
splay-name>13 KERA fcc</display-name> 
<display-name>KERA</display-name> 
<display-name>KERA</display-name> 
<display-name>PBS Affiliate</display-name> 
on src="file://C:\Perl\site/share/xmltv/icons/KERA.gif" /> 
</channel> 
<channel id="I10759, labs. zap2it .com"> 
splay-name>11 KTVT</display-name> 
<display-name>11 KTVT 1X42822:~-</display-name> 
<display-name>11</display-name> 
<display-name>11 KTVT fcc</display-name> 
<display-name>KTVT</display-name> 
<display-name>KTVT</display-name> 
splay-name>CBS Affiliate</display-name> 
on src="file://C:\Perl\site/share/xmltv/icons/KIVT 
</channel> 
<programme star 

<title lan 


chedules Direct" generator—info-name="XMLTV/$Id: t _na_dd.in,v 1.70 2008/03/03 15:21:41 rmeden Exp $" generator-info-url="http: //www.xmltv.org/"> 


20080715003000 -0600" stor 
en">NOW on PBS</title> 
"en">Jordan's Queen Rania has made job creation a priority to help curb the staggering unemployment rates amgng youths in the Middle Hast.</desc> 
<date>20080711</date> 


20080715010000 -0600" channe: 


"110436. labs. zap2it.com"> 


<category en" >Newsmagazine</category> 
<category en" >Interview</category> 
<category en">Public affairs</category> 
<category en" >Series</category> 


<episode-num system: 
<episode-num system 
<audio> 
<stereo>stereo</stereo> 
</audio> 
<previously-shown start="20080711000000" /> 
<subtitles type="teletext" /> 
</programme> 
<programme start="20080715010000 -0600" sto) 
<title lang="en">Mystery!</title> 
"en">Foyle's War, Series IV: Bleak Midwinter</sub-title> ! 
"en">Foyle investigates an explosion at a munitions factory, which he comes to believe may have been premedițated.</desc> 
<date>20070701</date> 
<category lang="en">Anthology</category> 
<category lang="en">Mystery</category> 
<category lang="en">Series</category> 
<episode-num system="dd_progid">EP00003026.0665</episode-num> 
<episode-num system="onscreen">2705</episode-num> 
<audio> 
<stereo>stereo</stereo> 
</audio> 
<previously-shown start="20070701000000" /> 
<subtitles type="teletext" /> 
</programme> 
<programme start="20080715023000 -0600" stop="20080715040000 -0600" channe: 
<title lang="en">Mystery!</title> 
<sub-title lang="en">Foyle's War, Series IV: Casualties of War</sub-title> 
"en">The murder of a prominent scientist may have been due to a gambling debt.</desc> 
<date>20070708</date> 
<category lang="en">Anthology</category> 
<category lang="en">Mystery</category> 
<category lang="en">Series</category> 
<episode-num system="dd_progid">EP00003026.0666</episode-num> 
<episode-num system="onscreen">2706</episode-num> 
<audio> 
<stereo>stereo</stereo> 
</audio> 
<previously-shown start="20070708000000" /> 
<subtitles type="teletext" /> 
</programme> 
<programme star 


id_progid">EP01006886 .0028</episode-num> 
"onscreen">427</episode-num> 


20080715023000 -0600" channe: 


"110436. labs. zap2it.com"> 


"110436. labs. zap2it.com"> 


20080715040000 -0600" stop="20080715043000 -0600" channe: 
<title lang=-"en">BBC World News</title> 
<desc lang="en">International issues.</desc> 
<category lang="en">News</category> 
<category lang="en">Series</category> 
<episode-num system="dd_progid”>SH00315789.0000</episode-num> 
<previously-shown /> 
<subtitles type="teletext" /> 
</programme> 
<programme start="20080715043000 -0600" stop="20080715050000 -0600" channe: 
<title lang="en">Sit and Be Fit</title> 
<date>20070924</date> 
<category lang="en">Exercise</category> 
<category lang="en">Series</category> 
<episode-num system="dd_progid">EP00003847.0074</episode-num> 
<episode-num system="onscreen">901</episode-num> 
<audio> 
<stereo>stereo</stereo> 
</audio> 
<previously-shown start="20070924000000" /> 
<subtitles type="teletext" /> 
</programme> 
<programme star 
<title lan 


"110436. labs. zap2it.com"> 


"110436. labs. zap2it.com"> 


"20080715060000 -0600" sto, 
jen">The Early Show</title> 
"en">Republican candidate John McCain; premiere of the film "The Dark Knight."</desc> 
<date>20080715</date> 

<category lang="en">Talk</category> 

<category lang="en">News</category> 

<category lang="en">Series</category> 

<episode-num system="dd_progid">EP00337003.2361</episode-num> 


"20080715080000 -0600" channe: 


"110759. labs. zap2it.com"> 


<audio> 
<stereo>stereo</stereo> 
</audio> 
<subtitles type="teletext" /> 
</programme> 
<programme start="20080715080000 -0600" stop="20080715090000 -0600" channel="110759.labs.zap2it.com"> 
<title lang="en">Rachael Ray</title> 
<desc lang="en">Actresses Kim Raver, Brooke Shields and Lindsay Price ("Lipstick Jungle"); women in their 40s tell why they got breast implants; a 30-minute meal.</desc> 
<credits> 
<presenter>Rachael Ray</presenter> 
</credits> 


<date>20080306</date> 

<category lang="en">Talk</category> 

<category lang="en">Series</category> 

<episode-num system="dd_progid">EP00847333.0303</episode-num> 

<episode-num system="onscreen">2119</episode-num> 

<audio> 

<stereo>stereo</stereo> 

</audio> 

<previously-shown start="20080306000000" /> 

<subtitles type="teletext" /> 
</programme> 
<programme star 

<title lan 


20080715090000 -0600" sto 
en">The Price Is Right</title> 
"en">Contestants bid for prizes then compete for fabulous showcases.</desc> 


20080715100000 -0600" channe: 


"110759. labs. zap2it.com"> 


<credits> 
<director>Bart Eskander</director> 
<producer>Roger Dobkowitz</producer> 
<presenter>Drew Carey</presenter> 
</credits> 
<category lang="en">Game show</category> 
<category lang="en">Series</category> 
<episode-num system="dd_progid">SH00004372.0000</episode-num> 
<audio> 
<stereo>stereo</stereo> 
</audio> 
<subtitles type="teletext" /> 
<rating system="VCHIP"> 
<value>TV-G</value> 
</rating> 
</programme> 
<programme start="20080715100000 -0600" sto 
<title lang="en">Jeopardy!</title> 
<credits> 
<presenter>Alex Trebek</presenter> 
</credits> 
<date>20080715</date> 
<category lang="en">Game show</category> 
<category lang="en">Series</category> 
<episode-num system="dd_progid">EP00002348.1700</episode-num> 
<episode-num system="onscreen">5507</episode-num> 
<subtitles type="teletext" /> 


20080715103000 -0600" channe: 


"110759. labs.zap2it.com"> 
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<rating system="VCHIP"> 
<value>TV-G</value> 
</rating> 
</programme> 
<programme start="20080715103000 -0600" sto, 
<title lang-"en">The Young and the Restless</title> 


<sub-title lang-"en">Sabrina Offers Victoria a Truce</sub-title> 
<desc lang="en">Jeff thinks Kyon stole the face cream; Nikki asks Nick to give David a 


<credits> 
<actor>Peter Bergman</actor> 
<actor>Eric Braeden</actor> 
<actor>Jeanne Cooper</actor> 
<actor>Melody Thomas Scott</actor> 

</credits> 

<date>20080715</date> 

<category lang="en">Soap</category> 

<category lang="en">Series</category> 


<episode-num system="dd_progid">EP00004422.1359</episode-num> 


<episode-num system: 
<audio> 
<stereo>stereo</stereo> 
</audio> 
<subtitles type="teletext" /> 
<rating system="VCHIP"> 
<value>TV-14</value> 
</rating> 
</programme> 


"onscreen">8937</episode-num> 


</tv> 


20080715113000 -0600" channel="110759.labs.zap2it.com"> 


chance; Amber begs Adrian to go to Australia.</desc> 


This page was last modified on 31 Decerrber 2008, at 01:38. 
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